… usage

- Add classifyIntent import to detect user intent (conversational, information, creation, modification)
- Add selectToolsByIntent to determine appropriate tools based on intent
- Implement generateConversationalResponse for direct conversational responses without orchestrator
- Update handleSend to classify intent before orchestrator execution
- Route CONVERSATIONAL intents to direct response handler
- Log tool selection for observability and debugging
- Maintain existing error handling and UI updates
- All TypeScript strict mode checks pass

…sage

- Add intentClassifier.ts for 4-tier intent classification (CONVERSATIONAL, INFORMATION_REQUEST, CONTENT_CREATION, CONTENT_MODIFICATION)
- Add toolSelector.ts for intent-based tool selection and safety checks
- Refactor CopilotPanel.tsx to route based on intent instead of always using tools
- Add conversational response generator for casual interactions
- Update system-prompt.md with Intent-First philosophy section and block structure principles
- Add 32 unit tests for intentClassifier with full coverage
- Add 17 unit tests for toolSelector with hierarchy validation
- Add 17 integration tests for intent-first routing scenarios
- All 66 tests passing, TypeScript strict mode clean

…hestrator

- Delete generateConversationalResponse() function with template responses
- Remove special-case handling for CONVERSATIONAL intent
- Always pass inputs through orchestrator with intent-based tool selection
- Intent classification now serves only to select appropriate tools, not to bypass AI
- All 66 tests passing, TypeScript clean, build succeeds

This ensures AI orchestrator makes all decisions rather than returning predetermined responses.

Add detailed decision framework explaining WHEN to use siblings vs children:
- Parallel items (genres, categories, options) → SIBLINGS
- Hierarchical parts (decomposition, sub-details) → CHILDREN
- Sequential items (steps, timeline) → SIBLINGS

Includes:
- Q&A decision framework for block relationships
- Real-world examples (genres, meeting notes, projects, to-do lists)
- Validation checklist to verify correct structure
- Clear anti-patterns to avoid (staircase nesting)

This teaches the AI the semantic meaning of block hierarchy, not just mechanics.
Fixes issue where AI creates overly nested structures for parallel items.

…udits

## Summary
Complete architectural documentation of the Oxinot Copilot system covering Intent-First routing, tool ecosystem, provider layer, UI integration, and semantic block guidance. Includes implementation details, audit findings, and Mermaid diagrams.

## Changes
- System Overview with detailed purpose and principles
- Intent-First Routing Philosophy (4 intent categories with patterns)
- Core Architecture with enhanced orchestrator details
  * State management and iteration control
  * Error recovery mechanisms
  * Task progress tracking
- Intent Classification with confidence scoring and multi-language support
- Tool System with complete ecosystem overview (25 tools across 6 categories)
  * Tool Registry pattern and validation
  * Safety levels and approval mechanisms
  * Tool dependencies and usage patterns
- Provider Layer documentation (7 LLM backends)
- UI/UX Architecture with React integration patterns
- Block Structure Semantics with decision framework
- Implementation Details tracking all changes and commits
- Wave 1 Audit Results structure for real-time audit integration
  * Core Logic audit (orchestrator, intent classifier, tool selector)
  * Tool Ecosystem audit (all 25 tools, registry, safety)
  * UI/Provider audit (complete)
- Mermaid diagrams:
  * Orchestrator State Machine
  * Intent Classification Decision Tree
  * Tool Selection Hierarchy
- Audit Findings & Future Work with recommendations
- Quick Reference guides for adding intents, tools, providers
- Complete Glossary and References

## Diagrams
- Orchestrator state machine (ReAct pattern flow)
- Intent classification decision tree (priority-based detection)
- Tool selection hierarchy (intent → tools mapping)

## Quality Checks
✅ Build: Success
✅ Lint: Pass (2 minor warnings in unrelated code)
✅ No code changes (documentation only)

…entation

## Wave 1 Audits Complete ✅

### Core Logic Audit (bg_13961ee2, 2m 46s)
- Complete data flow from user input to response
- Intent classification with 7-tier priority system
- Tool selection security hierarchy (4 levels)
- Orchestrator state machine with loop detection
- Error recovery with 8 error categories and 3 severity levels
- 3 loop detection strategies to prevent AI infinite loops

### Tool Ecosystem Audit (bg_c662b4c3, 6m 26s)
- 25 registered tools across 5 categories
- Tool registry architecture with O(1) lookups
- Safety/approval matrix with danger level classification
- Execution pipeline: Lookup → Approval → Validation → Execute → Events
- Tool usage patterns and dependency relationships
- Scalability analysis: Can handle 100+ tools with minor enhancements
- 4 additional filesystem tools defined but not yet registered

### Integrated Content
- Complete tool inventory table with all 25 tools
- Intent classification decision rules with pattern priorities
- Tool selection rules per intent (security hierarchy)
- Orchestrator state machine with transitions
- Loop detection strategies (same tool, read-only, verification)
- Error recovery system (categories, severity, strategies)
- Dependency architecture (context → discovery → creation → modification)
- Scalability recommendations (category index, event-driven approval)

### Document Statistics
- Lines: 1,032 → 1,185 (+153 lines)
- Sections: 10 major + audit details
- Code references: 40+
- Diagrams: 6 (3 ASCII + 3 Mermaid)
- Tables: 15+

### Quality Verification
✅ Build: 3.21s - Success
✅ Lint: 2 warnings (unrelated code)
✅ No code changes (documentation only)

…ame_file, move_file)

- Export filesystemTools array from filesystem/index.ts
- Import and register filesystem tools in initializeToolRegistry
- Fixes audit finding: 4 unregistered filesystem tools
- All tools properly defined with Zod schemas and safety flags

- Integrate useWorkspaceStore for directory loading
- Support both file and directory navigation
- Auto-detect markdown files and open them in editor
- Show directory contents in index view
- Match pages by file path with flexible patterns
- Properly handle path normalization and edge cases
- Fixes audit finding: incomplete navigate_to_path implementation

Extract 6 helper functions for cleaner code structure:
- resolvePageId() - Parameter resolution (pageId vs pageTitle)
- loadPageBlocks() - Blocks loading with error handling
- updatePageStore() - Page store state updates
- verifyStoreSync() - Store synchronization validation
- openPageInView() - View state management
- dispatchPageOpenedEvent() - UI event handling

Reduce verbose logging by 50+ statements:
- Remove debug state dumps and separator lines
- Keep only ERROR, WARN, INFO levels
- Unify log prefix to [openPageTool]

Result:
- 38% code reduction with 6 focused helper functions
- Main execute() reduced from 195 to 45 lines
- All functionality preserved, fully backward compatible
- TypeScript strict mode passes

Fixes audit finding: 381-line openPageTool too large for maintainability

Add categoryIndex Map to enable instant category lookups:
- Store tools grouped by category during registration
- getByCategory() now returns cached array instead of filtering
- Improve performance for intent-based tool selection
- Update/clear operations properly maintain index consistency

Performance improvement:
- getByCategory(category) changes from O(n) to O(1) lookup
- Scales better with 100+ tools (current: 25 tools)

Fixes audit finding: category index for O(1) filtering

Replace 100ms polling loop with Zustand store subscriptions:
- Create waitForApprovalDecision() helper using store.subscribe()
- Listen for real-time approval/denial state changes
- Implement 5-minute timeout to prevent infinite waiting
- Proper cleanup: unsubscribe on resolution prevents memory leaks
- Race condition protection: resolved flag prevents double resolution

Benefits:
- Eliminates 100ms polling interval overhead
- Immediate response to approval/denial (event-driven)
- Scales better with multiple pending tool approvals
- Reduces CPU usage for approval waiting
- Cleaner, more reactive code pattern

Same behavior, better performance. Fixes audit finding: event-driven approval system

- Move biome-ignore comment to correct line
- Replace non-null assertion (!) with optional chaining (?)
- Reduces lint warnings from 7 to 4 (fixed 3 related to registry)